home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / Music / MISC / DTMF / DTMF.doc < prev    next >
Text File  |  1995-08-23  |  4KB  |  94 lines
  1.  
  2.                                   DTMF Dialer
  3.  
  4.                  (c) 1995 Martin Mares, MJSoft System Software
  5.  
  6. ================================================================================
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.    The DTMF Dialer 1.2 and its documentation are Copyright (c) Martin Mares,
  13. MJSoft System Software, Prague, Czech Republic.
  14.  
  15.    This  archive  can  be  freely  redistributed as long as all of its files are
  16. included   in   their   original   form  without  any  additions,  deletions  or
  17. modifications  (excluding addition of other README-style files and icons) and no
  18. more  than a nominal fee is charged for its distribution.  All copyright notices
  19. in  the  programs and accompanying documentation files must remain intact.  It's
  20. especially  forbidden  to add various '.displayme' files and BBS advertisements.
  21. This style of distribution is generally known as FREEWARE.
  22.  
  23.    Source  text of this program is included in the distribution.  You can freely
  24. improve  it.   If  you  want  to  distribute your improved version, there're two
  25. possibilities:   (1)  Send  your  improvements  to  me  (the best form is a diff
  26. output)  and  I'll include them in the next release.  (2) Distribute them alone.
  27. In  this  case, you must mention the name of original author, change the name of
  28. the  product  (not  only  by  increasing  the  version),  and  obey  all  of the
  29. distribution rules mentioned above.
  30.  
  31.    Special  permission is given to Fred Fish to distribute this program on his
  32. "Fish Disks".
  33.  
  34.    This  software  is  provided  "AS  IS"  without  warranty of any kind, either
  35. expressed  or  implied.   The author is not responsible for any damage caused by
  36. it.
  37.  
  38.  
  39. Introduction
  40. ============
  41.  
  42.    Some people are connected to a digital telephone exchange which allows
  43. to use DTMF (dual-tone) dialing, but don't have a modem to dial with. This
  44. simple utility tries to dial the numbers through standard audio output.
  45.  
  46.    Features:
  47.  
  48.       - requires Kickstart 2.04 or higher and the ss.library V5 or higher
  49.         (can be found on the Aminet in archive SSLib<version>.lha)
  50.  
  51.       - dialing speed can be set
  52.  
  53.       - the number or file to be dialed can be entered as a command-line
  54.         parameter
  55.  
  56.       - nice user interface using MUI (Magic User Inteface © Stefan Stuntz).
  57.         Doesn't require the MUI if run with given number as an argument.
  58.  
  59.       - DTMF is pure and can be made resident. -- Very useful :-)
  60.  
  61.       - Source code in assembly included, allowing custom modification.
  62.         Also can serve as an example how to write good space-efficient code
  63.         using MUI (But isn't it better to use Triton that has the same
  64.         capabilities and is four times shorter? ... When I have written this,
  65.         Triton didn't exist and I'm too lazy to rewrite it now.). The original
  66.         MUI macros are very bad. :-(
  67.  
  68.  
  69. Usage
  70. =====
  71.  
  72.    DTMF may be called either from the CLI or from the Workbench.
  73.  
  74.    If started from the CLI, it has the following options:
  75.  
  76.       NUMBER - number to be dialed. If not specified, GUI mode entered.
  77.                0-9, #, * and A-D digits are recognised. All other characters are
  78.                treated as spaces.
  79.  
  80.       RATE/K - duration of one digit in miliseconds. The inter-digit space
  81.                has the same length.
  82.  
  83.       FILE/K - file you want to dial, processed as if entered as NUMBER.
  84.  
  85.    If started from the Workbench, these options can be specified by the
  86. tool types (you can make a project icon to dial some number...).
  87.  
  88.  
  89. Notes
  90. =====
  91.  
  92.    Send comments, suggestions and bug reports to mjsoft@k332.feld.cvut.cz
  93.  
  94.